Viscom Mini-Mall(tm) and ABS Online Checks Direct!(tm) v1.01 for Synchronet 2.x Copyright 1995 by Viscom Corporation -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Viscom Mini-Mall is a complete online shopping system for Synchronet BBS's. Viscom Mini-Mall supports sales of products, services, downloadable software and text files, BBS subscriptions through a MODUSER.DAT file, and the sale of software registeration keys. An open ended architecture has been used in the design of this shopping system. This allows the Sysyop almost 99% control over the apperance and operation of the Mini-Mall. ABS's Online Checks Direct(tm) is included with Viscom Mini-Mall. ----------------------------------------------------------------- With ABS's Online Checks Direct(tm) service, you can offer your callers the convenience of subscribing or making a purchase by filling out a check on-line! Check information is collected and sent directly to ABS for processing. ABS produces the checks and sends them directly to you ready for deposit. You can have your checks within 24 to 48 hours, hassle-free, no wait! Key Features: ============= * Automated online sales * You can run multiple copies to allow an unlimited number of malls, stores, departments and products. * Multiple copies can be integrated through the use of BAJA bin files and custom menus. * Sell downloadable software products * Create and sell software registration keys * Sell multiple BBS subscription plans with automatic updating of the users levels and flags via a MODUSER.DAT file. * Tax rate and State to be taxed * E-Mail's receipts to users * E-Mail's purchase orders and activity reports to the sysop or any user you designate. This is done by individual product so you can have different users responsible for different products or stores. Multi-Merchant capability. * E-Mail purchased documents to users. * Allow access to different malls and/or stores from different locations within your BBS! * Automatic city and state lookups for zip codes * 99% Sysop configurable! * And More....... Installation: ============ 1. Create a directory called "VISMM" off of your Synchronet XTRN directory. Example: MD C:\SBBS\XTRN\VISMM 2. Create three sub directories off of the above directory called OUT, BACKUP, and LOG. Example: MD C:\SBBS\XTRN\VISMM\OUT and MD C:\SBBS\XTRN\VISMM\BACKUP and MD C:\SBBS\XTRN\VISMM\LOG 3. Copy all VISMM files into this new directory. Example: COPY *.* C:\SBBS\XTRN\VISMM Note, VISMM files include: VISMM.TXT This file ABSINFO.TXT Information about Online Checks Direct(tm) SIGNUP.TXT Signup information for ABS ABSFORM.BMP Signup form in BMP format ABSFORM.PCX Signup form in PCX format VISMM.EXE Expire User Notifier external program VISMM.CFG Program configuration file VMPROC.EXE Prepares check data for transmission to ABS VMPROC.CFG Configuration file for VMPROC.EXE ABS.SLT Telix salt script for sending check data OPENING Opening screen MAINMENU Mall Main Menu INSTRUCT Instructions for users CATALOG Catalog of products SELECT Selection of products REC#.TXT Receipts E-mailed to users REC#T.TXT Receipts E-Mailed to users, taxable sales PO#.TXT Purchase orders E-Mailed to sysop or merchant PO#T.TXT Same as above but for taxable sales VZIP.DBF Zip Code data base VZIP.MDX Index for the Zip Code data base 4. Run SCFG from your NODE1 directory. 5. Go to the External Programs->External Programs menu. Then create or select the section to install the program. Then install the main mini-mall as a external program. Example SCFG screen: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º Viscom Mini-Mall º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º ³Name Viscom Mini-Mall º º ³Internal Code VISMM º º ³Start-up Directory ..\XTRN\VISMM º º ³Command Line VISMM º º ³Clean-up Command Line º º ³Cost in Credits 0 º º ³Access Requirements º º ³Execution Requirements º º ³Multiple Concurrent Users Yes º º ³Intercept I/O Interrupts Yes º º ³Swap BBS out of Memory Yes º º ³Modify User Data Yes º º ³Execute on Event No º º ³BBS Drop File Typee (R) Synchronet XTRN.DAT º º ³Place Drop File In Node Directory º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Configuration: ============= 1. Go into your VISMM directory and edit the file VISMM.CFG. Example: CD \SBBS\XTRN\VISMM EDIT VISMM.CFG You will see a file containg the following information: LINE # DESCRIPTION ------ ------------------------------- 1 [USER INFORMATION] 2 Time Zone 3 SBBS CTRL Path 4 Path to SBBS MAIL file 5 Path to main purchases directory 6 Path to OUT directory 7 Path to BACKUP directory 8 Path to activity LOG 9 Path to SBBS DATA FILE directory 10 [CHECK PAY TO INFORMATION] 11 name, company, or bbs name 12 [PURCHASE OPTIONS MENU CHOICES 1 - 9] 13 Number of menu choices 1-9 14 menu choices string ex. 123456789 15 [OPTION 1] 16 memo line on check 17 price 18 taxable? 19 what state? 20 amount of tax 21 surcharge if any 22 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 23 e-mail orders to user name 24 e-mail orders to user # 25 credit adjustment 26 security level 27 flags #1 to add 28 flags #2 to add 29 exemptions to add 30 restrictions to add 31 days to add to expiration date 32 minutes to add to minute bank 33 flags #3 to add 34 flags #4 to add 35 flags #1 to remove 36 flags #2 to remove 37 flags #3 to remove 38 flags #4 to remove 39 exemptions to remove 40 restrictions to remove 41 receipt file name 42 receipt file name taxable sale 43 purchase order file name 44 purchase order file name taxable sale 45 file to attach to e-mail 46 path to attached e-mail file 47 encryption key string 48 [OPTION 2] 49 memo line on check 50 price 51 taxable? 52 what state? 53 amount of tax 54 surcharge if any 55 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 56 e-mail orders to user name 57 e-mail orders to user # 58 credit adjustment 59 security level 60 flags #1 to add 61 flags #2 to add 62 exemptions to add 63 restrictions to add 64 days to add to expiration date 65 minutes to add to minute bank 66 flags #3 to add 67 flags #4 to add 68 flags #1 to remove 69 flags #2 to remove 70 flags #3 to remove 71 flags #4 to remove 72 exemptions to remove 73 restrictions to remove 74 receipt file name 75 receipt file name taxable sale 76 purchase order file name 77 purchase order file name taxable sale 78 file to attach to e-mail 79 path to attached e-mail file 80 encryption key string 81 [OPTION 3] 82 memo line on check 83 price 84 taxable? 85 what state? 86 amount of tax 87 surcharge if any 88 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 89 e-mail orders to user name 90 e-mail orders to user # 91 credit adjustment 92 security level 93 flags #1 to add 94 flags #2 to add 95 exemptions to add 96 restrictions to add 97 days to add to expiration date 98 minutes to add to minute bank 99 flags #3 to add 100 flags #4 to add 101 flags #1 to remove 102 flags #2 to remove 103 flags #3 to remove 104 flags #4 to remove 105 exemptions to remove 106 restrictions to remove 107 receipt file name 108 receipt file name taxable sale 109 purchase order file name 110 purchase order file name taxable sale 111 file to attach to e-mail 112 path to attached e-mail file 113 encryption key string 114 [OPTION 4] 115 memo line on check 116 price 117 taxable? 118 what state? 119 amount of tax 120 surcharge if any 121 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 122 e-mail orders to user name 123 e-mail orders to user # 124 credit adjustment 125 security level 126 flags #1 to add 127 flags #2 to add 128 exemptions to add 129 restrictions to add 130 days to add to expiration date 131 minutes to add to minute bank 132 flags #3 to add 133 flags #4 to add 134 flags #1 to remove 135 flags #2 to remove 136 flags #3 to remove 137 flags #4 to remove 138 exemptions to remove 139 restrictions to remove 140 receipt file name 141 receipt file name taxable sale 142 purchase order file name 143 purchase order file name taxable sale 144 file to attach to e-mail 145 path to attached e-mail file 146 encryption key string 147 [OPTION 5] 148 memo line on check 149 price 150 taxable? 151 what state? 152 amount of tax 153 surcharge if any 154 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 155 e-mail orders to user name 156 e-mail orders to user # 157 credit adjustment 158 security level 159 flags #1 to add 160 flags #2 to add 161 exemptions to add 162 restrictions to add 163 days to add to expiration date 164 minutes to add to minute bank 165 flags #3 to add 166 flags #4 to add 167 flags #1 to remove 168 flags #2 to remove 169 flags #3 to remove 170 flags #4 to remove 171 exemptions to remove 172 restrictions to remove 173 receipt file name 174 receipt file name taxable sale 175 purchase order file name 176 purchase order file name taxable sale 177 file to attach to e-mail 178 path to attached e-mail file 179 encryption key string 180 [OPTION 6] 181 memo line on check 182 price 183 taxable? 184 what state? 185 amount of tax 186 surcharge if any 187 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 188 e-mail orders to user name 189 e-mail orders to user # 190 credit adjustment 191 security level 192 flags #1 to add 193 flags #2 to add 194 exemptions to add 195 restrictions to add 196 days to add to expiration date 197 minutes to add to minute bank 198 flags #3 to add 199 flags #4 to add 200 flags #1 to remove 201 flags #2 to remove 202 flags #3 to remove 203 flags #4 to remove 204 exemptions to remove 205 restrictions to remove 206 receipt file name 207 receipt file name taxable sale 208 purchase order file name 209 purchase order file name taxable sale 210 file to attach to e-mail 211 path to attached e-mail file 212 encryption key string 213 [OPTION 7] 214 memo line on check 215 price 216 taxable? 217 what state? 218 amount of tax 219 surcharge if any 220 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 221 e-mail orders to user name 222 e-mail orders to user # 223 credit adjustment 224 security level 225 flags #1 to add 226 flags #2 to add 227 exemptions to add 228 restrictions to add 229 days to add to expiration date 230 minutes to add to minute bank 231 flags #3 to add 232 flags #4 to add 233 flags #1 to remove 234 flags #2 to remove 235 flags #3 to remove 236 flags #4 to remove 237 exemptions to remove 238 restrictions to remove 239 receipt file name 240 receipt file name taxable sale 241 purchase order file name 242 purchase order file name taxable sale 243 file to attach to e-mail 244 path to attached e-mail file 245 encryption key string 246 [OPTION 8] 247 memo line on check 248 price 249 taxable? 250 what state? 251 amount of tax 252 surcharge if any 253 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 254 e-mail orders to user name 255 e-mail orders to user # 256 credit adjustment 257 security level 258 flags #1 to add 259 flags #2 to add 260 exemptions to add 261 restrictions to add 262 days to add to expiration date 263 minutes to add to minute bank 264 flags #3 to add 265 flags #4 to add 266 flags #1 to remove 267 flags #2 to remove 268 flags #3 to remove 269 flags #4 to remove 270 exemptions to remove 271 restrictions to remove 272 receipt file name 273 receipt file name taxable sale 274 purchase order file name 275 purchase order file name taxable sale 276 file to attach to e-mail 277 path to attached e-mail file 278 encryption key string 279 [OPTION 9] 280 memo line on check 281 price 282 taxable? 283 what state? 284 amount of tax 285 surcharge if any 286 action type = P=po, M=moduser.dat, F=file attach, K=Gen. a key file 287 e-mail orders to user name 288 e-mail orders to user # 289 credit adjustment 290 security level 291 flags #1 to add 292 flags #2 to add 293 exemptions to add 294 restrictions to add 295 days to add to expiration date 296 minutes to add to minute bank 297 flags #3 to add 298 flags #4 to add 299 flags #1 to remove 300 flags #2 to remove 301 flags #3 to remove 302 flags #4 to remove 303 exemptions to remove 304 restrictions to remove 305 receipt file name 306 receipt file name taxable sale 307 purchase order file name 308 purchase order file name taxable sale 309 file to attach to e-mail 310 path to attached e-mail file 311 encryption key string 312 [END VISMM.CFG] The description of each line is as follows. Edit this file to fit your BBS system configuration and needs. Do not remove any of the lines in this file. They are needed for proper execution. ----------------------------------------------------------------------------- [USER INFORMATION] EST *** Enter the abbreviation for your time zone I:\SBBS\CTRL\ *** Enter the path to your SBBS control directory I:\SBBS\DATA\ *** Enter the path to your SBBS MAIL.SHD file I:\SBBS\XTRN\VISMM\ *** Enter the path to your MAIN Mini-Mall program *** This allows you to install as many malls as you need *** and have the MAIN mall collect all of the charges data. I:\SBBS\XTRN\VISMM\OUT\ *** Enter the path to your MAIN mini-Mall OUT directory. I:\SBBS\XTRN\VISMM\BACKUP\ *** Enter the path to your MAIN mini-Mall BACKUP directory. I:\SBBS\XTRN\VISMM\LOG\ *** Enter the path to your local or MAIN mini-Mall LOG directory. I:\SBBS\DATA\FILE\ *** Enter the path to your SBBS data file directory. ----------------------------------------------------------------------------- [CHECK PAY TO INFORMATION] Viscom Corporation *** Enter the name that you would like to appear on any pat to *** lines. ----------------------------------------------------------------------------- [PURCHASE OPTIONS MENU CHOICES 1 - 9] 4 *** Enter the number of menu choices for this Mini-Mall. *** The maximum is 9. 1234 *** Enter the valid menu choices for product selection for this *** Mini-Mall. Examples, 5 items = 12345, 9 items = 123456789 ----------------------------------------------------------------------------- ******* THIS IS A SAMPLE OF A BBS SUBSCRIPTION OPTION ******* [OPTION 1] Standard Subscription $10.00 per Month *** Description of product to display and include on memo fields *** of checks. 10.00 *** The price for this product. N *** Is this product taxable? *** Enter (Y)es or (N)o SC *** State to collect tax from. Not used if taxable is set to N 0.00 *** Amount of tax to collect 0.00 *** Surcharge or shipping for product M *** Enter the appropriate action code *** Since this is an option that creates a MODUSER.DAT *** file we enter the code M. Sysop *** This is the user name to send po's or confirmations to *** when a user purchases this option 1 *** This is the SBBS user number for the above sysop or user 0 *** Number of credits to add or subtract from the users account 15 *** Security level to assign user A C J *** Flags #1 to add to user account. WATCH POSITIONS OF FLAGS! *** Flags #2 to add to user account. In this cas we are not adding *** any so the line is left blank. *** Exemptions to add to users account or leave blank for none. *** Restrictions to add to users account or leave blank for none. 30 *** Number of days to add to users expiration date 0 *** Minutes to add to users minute bank *** Flags #3 to add to users account or leave blank for none. P *** Flags #4 to add to users account or leave blank for none. *** Flags #1 to remove from users account *** Flags #2 to remove from users account *** Flags #3 to remove from users account *** Flags #4 to remove from users account *** Exemptions to remove from users account *** Restrictions to remove from users account REC1.TXT *** Name of file containing text for E-mail message or *** receipt to be sent to user REC1T.TXT *** Name of file containing text for E-mail message or *** receipt to be sent to user that is calling from the *** state you have declared as taxable. This option is *** only active if Taxable = Y and the caller is calling *** from the designated state. PO1.TXT *** Name of file containing text for E-mail message or *** purchase order to be sent to the sysop or merchant PO1T.TXT *** Name of file containing text for E-mail message or *** purchase order to be sent to the sysop or merchant *** This file is used for taxable sales only. *** Name of file to attach to e-mail *** Path to the above attached e-mail file *** Encryption key string to pass to key generator module *** After the registration key is created, it will be E-Mailed *** to the user. ----------------------------------------------------------------------------- ******* THIS IS A SAMPLE DOWNLOADABLE SOFTWARE PURCHASE OPTION ******* [OPTION 2] Med Claim Pro $199.95 195.95 N SC 0.00 0.00 F *** Enter the appropriate action code *** Since this is an option that sends a program to the user *** we enter the code F. Sysop 1 REC3.TXT REC3T.TXT PO3.TXT PO3T.TXT MCP201.ZIP *** This is the name of the file to be file attached to E-mail *** to the user *** NOTE:!!! Make sure that this file exists. Point it to a real *** file on your system!!! I:\SBBS\DATA\DIRS\VISCOM\ *** This is the directory where the file to attach to E-mail *** is located *** NOTE:!!! Make sure that this path exists. Point it to a real *** path on your system!!! ----------------------------------------------------------------------------- ******* THIS IS A SAMPLE OF A PRODUCT PURCHASE OPTION ******* [OPTION 3] Two Line Telephone $125.00 125.00 Y *** This is a taxable sale if purchased by a user from *** the state listed below SC *** State to collect sales tax in 6.25 *** Amount of sales tax 5.00 *** This is the amount of shipping to add to the purchase P *** Enter the appropriate action code *** Since this is an option to purchase a product *** we enter the code P. Gary Smith *** Since this product is shipped by a merchant, we want to *** send the purchase order to him instead of the sysop 78 *** This is the merchants SBBS user number REC3.TXT REC3T.TXT PO3.TXT PO3T.TXT ----------------------------------------------------------------------------- ******* THIS IS A SAMPLE REGISTRATION KEY PURCHASE OPTION ******* [OPTION 4] Reg key for Super Accounting $129.95 129.95 Y SC 6.50 0.00 K *** Since we want to generate a registration key we set this *** option to K. The registration key will be E-mailed via *** a file attach to the user. Sysop 1 REC4.TXT REC4T.TXT PO4.TXT PO4T.TXT flkj34983098ef3459080pfgjk45-08eetj305vmn305982-873-09383-9 *** This is the encryption string to pass to the key generator *** for this product. ----------------------------------------------------------------------------- 2. Edit or create all of the purchase receipts, purchase orders, catalog and screens to suit your needs and taste. 3. Edit the configuration file VMPROC.CFG as follows; [VMPROC CONFIGURATION FILE] <--- DO NOT MODIFY THIS LINE! VIS99 <--- Enter your ABS assigned ID <--- Leave this line blank (For future use) I:\SBBS\XTRN\VISMM\OUT\ <--- Enter the path to your vismm out directory I:\SBBS\XTRN\VISMM\BACKUP\ <--- Enter the path to your vismm backup Dir. 4. Edit the enclosed telix salt script and enter your ABS login information and paths. See the comments contained in ABS.SLT for more information. The program VMPROC.EXE creates a data file to be transmitted to ABS. This program can be run up to 20 times per day. The reccomended procedure is to call this program from a nightly event and then run telix with the provided salt script to upload the data to ABS. If you have any problems setting things up, please call me and I will be happy to walk you through it. Rob Whisonant Viscom Corporation How to contact the author and ABS: ================================== Sales & Service --------------- American Banking Systems Corporation Ph: 904-729-3006 Fx: 904-729-2188 BBS: 904-729-3827 Technical Support & Setup Questions ----------------------------------- Rob Whisonant Viscom Corporation PO Box 197 York, SC 29745 (803)628-1222 voice (803)684-5342 fax (803)684-0356 bbs ViscomNet(tm) DOVE-Net